home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / bgdial11.zip / dial.doc next >
Text File  |  1991-03-04  |  8KB  |  201 lines
  1. Name
  2.       dial
  3.  
  4. Purpose
  5.  
  6.       To repeatedly dial a list of telephone numbers until one of
  7.       them answers by issuing commands for hayes-modems. The dial 
  8.       process is executed in 'background' so that the user can use 
  9.       other programs while waiting for the dial to complete.
  10.  
  11.  
  12. Syntax
  13.  
  14.       dial [-i<initstr>][-k<comb>][-w<secs>][-b<secs>]
  15.       <port> <speed><parity><data><stop> <tel> [tel]..
  16.       
  17.       dial -q
  18.  
  19.  
  20. Parameters
  21.  
  22.       <port> is the com port number on which the modem is attached. Ports 
  23.       from 1 to 4 are supported. 
  24.  
  25.       <speed><parity><data><stop> specifies the communication parameters
  26.       as follows :
  27.       
  28.          <speed>  :  communication speed (bps). Legal values are 300, 1200
  29.                      2400, 4800, 9600, 14400, 19200 and 38400.
  30.          <parity> :  parity, one of N (none), O (odd), E (even)
  31.          <data>   :  number of data bits (7 or 8)
  32.          <stop>   :  number of stop bits (1 or 2)
  33.          
  34.       <tel> [tel] .. specifies the numbers to call. Since dial 'glues'
  35.       the telephone numbers directly to the ATD command, all the dial
  36.       modifiers (such as 'P' for pulse dial or 'T' for tone dial) can
  37.       be used here.
  38.  
  39.  
  40. Options
  41.  
  42.       The options can be preceeded by either the '-' character
  43.       or the ms-dos default '/' character. They may appear in 
  44.       any order, but always before the arguments.
  45.  
  46.       The options are :
  47.  
  48.       -i :  Specify an initialization string fed to the modem
  49.             before issuing first dial command. The string is
  50.             fed to the modem 'as is', so the AT-prefix must
  51.             preceede a command here. Refer to your modem's 
  52.             manual for information about the commands.
  53.  
  54.  
  55.       -k :  Specify an abort key combination. When these keys
  56.             are held down for about one second, a beep is emitted
  57.             from the pc speaker and dial is aborted.
  58.             
  59.             <comb> is made up of r, l, c and a, where :
  60.                
  61.                r : right shift
  62.                l : left shift
  63.                c : ctrl
  64.                a : alt 
  65.             
  66.             A valid combination must contain at least two keys.
  67.                
  68.             By default there is no abort key combination, because
  69.             such a combination might interfere with the use of
  70.             other programs. 
  71.  
  72.  
  73.       -w :  Specify a 'hard' wait time of the lenght of <secs> 
  74.             seconds. After this time has passed since issuing 
  75.             the dial command the dial proceeds to the next number.
  76.             Otherwize, whatever message from the modem (such as 
  77.             'BUSY') causes dial to proceed to the next number.
  78.             By default this wait time is 30 seconds. The maximum
  79.             for this time is 300 seconds.
  80.  
  81.        
  82.       -b :  Specify a wait time between dials of the length of 
  83.             <secs> seconds. This is useful, if you'd like to 
  84.             give a change to someone calling to you to get 
  85.             trough while dial is running. By default there is
  86.             no wait time between calls (except that for technical
  87.             reasons). The maximum for this time is 300 seconds.
  88.             
  89.             If a wait time between the calls is specifed, dial
  90.             is aborted if the result code 'RING' is sent by
  91.             the modem while waiting. The abortion is signaled 
  92.             by a beep emitted from the pc speaker.
  93.  
  94.             
  95.       -q :  Abort a previously started dial. A beep is emitted
  96.             from the pc speaker as aborting.
  97.  
  98.  
  99. Comments      
  100.  
  101.       Dial issues hayes dial commands to the modem, until one of the
  102.       numbers in the list answers causing a string starting with
  103.       'CONNECT' to be sent from the modem. Dial can also be terminated
  104.       by user request (dial -q or a hotkey sequence) during the dial. 
  105.       At this point, dial releases all the memory reserved by it and 
  106.       restores the captured interrupt vectors essential for the 
  107.       background operation. At the time dial is assumed to be terminated 
  108.       successfully, a series of beebs is emitted from the pc speaker.
  109.       In case of premature termination a single beep is emitted instead.
  110.     
  111.       Before the actual dialing starts, an initialization string is
  112.       fed to the modem (if one is specified). After this, the modem
  113.       is fed the commands needed to turn echo from the modem off and
  114.       to get word response codes. 
  115.       
  116.       The following table lists the assumed io base addresses and 
  117.       interrupts for each port :
  118.       
  119.          port     io base (hex.)    interrupt (hex.)
  120.          
  121.          1        3f8h              0ch               (std.)
  122.          2        2f8h              0bh               (std.)
  123.          3        3e8h              0ch               (may vary)
  124.          4        2e8h              0bh               (may vary)
  125.  
  126.  
  127.       Dial does not have a possibility to store certain sets of
  128.       numbers and settings permanently in files, but this can
  129.       be accomplished by writing the dial command itself as a
  130.       .bat -file.
  131.       
  132.  
  133. Examples
  134.  
  135.       dial 2 1200N81 12345 67890 13579
  136.         
  137.         Repeatedly dial numbers 12345, 67890 and 13579 using com2 at 
  138.         1200 bps, no parity, 8 data bits, 1 stop bit.
  139.         
  140.         
  141.       dial 2 1200N81 t12345 t67890 t13579
  142.         
  143.         As above, but enforce tone dialing for all numbers.
  144.         
  145.         
  146.       dial -w45 -b60 -klca 2 2400E71 12345 67890
  147.         
  148.         Repeatedly dial numbers 12345 and 67890 using com2 at 
  149.         2400 bps, no parity, 7 data bits, 1 stop bit. Wait
  150.         up to 45 seconds for carrier. Be idle 60 seconds 
  151.         after each number.  Abort, if users keeps left shift-, 
  152.         ctrl- and alt-keys depressed for about a second. 
  153.         
  154.         
  155.       dial -iATM0 3 9600N81 12345 13579
  156.         
  157.         Repeatedly dial numbers 12345 and 13579 using com3 at 
  158.         9600 bps, no parity, 8 data bits, 1 stop bit. Issue
  159.         hayes 'speaker off' -command before starting to dial.
  160.         
  161.         
  162. Return value
  163.  
  164.       If successfully started, dial returns 0 and remains resident
  165.       in the memory. In other case 1 is returned to signal failure
  166.       (e.g. missing arguments or dial already running).
  167.         
  168.  
  169. Bugs and caveats
  170.  
  171.       Actually, there is no such thing as multitasking in the plain
  172.       MS-DOS environment. Therefore, this program may not work with
  173.       all configurations or with all programs. (Once again) this TSR 
  174.       is required to be loaded as the last one to ensure proper 
  175.       'unloading' and operation. 
  176.       
  177.       In case some other program has blocked the int 0x28, even a
  178.       terminated dial may still be resident in memory, causing
  179.       dial to fail if re-executed. In this case, run dial as 'dial 
  180.       -q'. This always generates an int 0x28, thus providing the
  181.       resident dial a change to terminate. 
  182.       
  183.       The program may not work at the higher communication speeds. 
  184.       It has been reported to work at speeds up to 9600 bps. Even
  185.       higher speeds are provided, however, because there is no 
  186.       known reason why they certainly wouldn't work. 
  187.       
  188.       The wait time specified by the -w option has no effect if it
  189.       is longer than that the modem itself will wait for a call to
  190.       complete. Use the -i option to set the modem's wait time if
  191.       needed.
  192.       
  193.       
  194. -----------------------------------------------------------------------------
  195. Dial.exe was written using Borland's Turbo C by Jouni Leppäjärvi (C) 1990, 1991
  196. (jml@stekt.oulu.fi). It and the documentation provided with it may be used 
  197. and copied freely on a non-commercial basis. The program and the documentation 
  198. are provided 'as is' with no warranty of any kind. Comments and bug reports
  199. are wellcome. (v 1.1, March 4, 1991)
  200. -----------------------------------------------------------------------------
  201.